home *** CD-ROM | disk | FTP | other *** search
/ Mac Magazin/MacEasy 21 / Mac Magazin and MacEasy Magazine CD - Issue 21.iso / Online / URL_Forward_1.0 / Read Me < prev    next >
Text File  |  1996-03-25  |  4KB  |  88 lines
  1.                                  URL Forward
  2.  
  3.                      Copyright 1994-95, by Thomas Reed
  4.  
  5. URL Forward is a simple background-only application designed to forward Get
  6. URL ('GURL') AppleEvents or AppleScripts to Internet Config. URL Forward is
  7. freeware, so distribute it to anyone you like. Just don't redistribute
  8. modified versions, and don't charge anyone for it!
  9.  
  10. The Get URL event is designed to request that a particular application go to
  11. that URL (or in the case of a mailto URL, to start a new message to that
  12. URL). Many programs, like FileMaker or QuicKeys, allow you to send
  13. AppleEvents to particular programs or run AppleScripts, but this
  14. functionality is not quite complete. If you want the URL intelligently
  15. handed off to the proper program, you must go through Internet Config, which
  16. can't be sent GURL events. This program bridges the gap and allows such
  17. programs to hand off URLs to the proper program.
  18.  
  19. Using URL Forward with Apple Events
  20.  
  21. Just have your program send a GURL event containing the desired URL to URL
  22. Forward. If you have Internet Config installed, the URL will be opened
  23. immediately.
  24.  
  25. If you don't know the structure of a GURL event, here are some simple
  26. instructions for how to send one. First, the Event Class and Event ID of a
  27. GURL event are both 'GURL' (without the quotes, of course). This is all that
  28. is required to tell a program what event is being sent. The event contains
  29. one parameter containing the URL in plain text format. Different programs
  30. will handle this differently.
  31.  
  32. In FileMaker, as an example, you would set up a new script and put the Send
  33. Apple Event command in the script. Then click the Send Apple Event command
  34. in the script's command list and click the "Specify..." button. In the
  35. pop-up near the top of the resulting dialog, choose "Other..." and type in
  36. 'GURL' in both fields, then click OK. Next, click the Field Value button and
  37. specify the field containing the URL (assuming you have a field that
  38. contains ONLY the URL). Then click the "Specify Application..." button,
  39. select URL Forward, and click Open. Note that you should NOT have the script
  40. bring the application to the front! This will cause the script to fail.
  41.  
  42. Using URL Forward with AppleScripts
  43.  
  44. Scripting URL Forward is much easier than using Apple Events for the novice
  45. user. Just use the following simple script:
  46.  
  47. tell application "URL Forward"
  48.   GetURL "someurl"
  49. end tell
  50.  
  51. That's all there is to it! Of course, the script gets more complicated when
  52. you add ways to extract the URL from different sources, but talking to URL
  53. Forward requires only those three lines.
  54.  
  55. Quitting URL Forward
  56.  
  57. If you ever want to quit URL Forward, you can use the enclosed AppleScript.
  58.  
  59. Optimizing URL Forward
  60.  
  61. If you are running URL Forward on a non-PowerMac, you can safely reduce it's
  62. memory requirements to around 30K. On a PowerMac it will run native, but
  63. unfortunately, it requires 75K. If you want, you can always use a utility to
  64. strip out the PowerMac code if you want a 68K-only version. Just remember
  65. not to redistribute modified versions!
  66.  
  67. Contacting the author
  68.  
  69. My name is Thomas Reed. You may send mail to ThomasReed@aol.com if you have
  70. any questions about or problems with this program. Updates, plus all kinds
  71. of other fun stuff, will be posted on my WWW page at:
  72.  
  73.      http://members.aol.com/thomasreed/
  74.  
  75. Hope you enjoy the program!
  76.  
  77. Version history
  78.  
  79. Version 1.0
  80.  
  81.    * URL Forward is now scriptable
  82.    * Improved error handling, including a notification if Internet Config is
  83.      not installed
  84.  
  85. Version 1.0b2
  86.  
  87.    * First public release
  88.